Trucking Company

• AssignTrkcToDriver    1

• AssignTruckingCompanyToUnit    1

• RejectTrkcLineBanned    1

• RejectTruckingCoMatchesExamOrSeizedCargoCarrier    1

• RejectTruckingCompanyAssignmentRequired    1

• RejectTruckingCompanyBanned    1

• RejectTruckingCompanyDeprecated    1

• RejectTruckingCompanyExpiredDriverAgreement    1

• RejectTruckingCompanyExpiredInsurance    1

• RejectTruckingCompanyExpiredLineAgreement    1

• RejectTruckingCompanyLineExpiredCredit    1

• RejectTruckingCompanyLineExpiredInsurance    1

• RejectTruckingCompanyMoveRestriction    1

• RejectTruckingCompanyNoLineAgreement    1

• RejectTruckingCompanyNoDriverAgreement    1

• RejectTruckingCompanyNotAssignedForPickup    1

• RejectTruckingCompanyNotExamSiteCarrier    1

• RejectTruckingCompanyNotMatchingTruckRecord    1

• RejectTruckingCompanyNotSeizedCargoCarrier    1

• RejectTruckingCompanyUnknown    1

• RejectTruckingCoNotMatchingDesignatedBondedCarrier    1

AssignTrkcToDriver

Assigns the trucking company for the current truck visit to the specified truck driver. When the truck driver returns for another truck visit, N4 automatically fills in the trucking company information when the gate clerk enters the truck driver's license number; however, the gate clerk can edit the information, if necessary.

AssignTruckingCompanyToUnit

Description

The business task assigns the trucking company (on page 1) that you specify at the gate, to the unit that is being created as part of the gate transaction.

If you use an auto update rule for the UNIT_RECEIVE event that uses the trucking company as a filter criteria, you must include this business task for the gate transaction type.

You could sometimes receive a container associated with one trucking company and then have to deliver the same container on a truck belonging to a different trucking company. In such cases, you must include the AssignTruckingCompanyToUnit business task at the first gate stage in your gate configuration for deliver (DM or DI) transactions. This ensures that N4 sends the correct trucking company to XPS (TRKC attribute) and Equipment Control (Trk Cmp in the Unit Details screen).

If you want to override the business security validation due to the user's business group limitation, you can include this business task for the DI, DM, RE, and RM Gate Appointment stage transactions. When you include the business task, a CAP user belonging to a trucking company A, for example, can create an appointment for his trucking company for a unit which was dropped to the terminal by a different trucking company B.

Parameters

None

Dependencies

None

Timing

For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).

Custom Code

None

RejectTrkcLineBanned

Rejects a gate transaction if the specified trucking company does not have a valid agreement with the line operator, or if the line operator has restricted the specified gate transaction type for the trucking company.

RejectTruckingCoMatchesExamOrSeizedCargoCarrier

For units inbond or marked for an offsite exam, this business task prevents the consignee-designated trucking company from taking the unit even if the trucking company is an authorized Exam Site or Seized Cargo carrier.

RejectTruckingCompanyAssignmentRequired

Rejects a gate transaction if the unit being delivered at the gate does not have a trucking company assigned. You can use the Delivery Requirements form or the Group form (on page 1) to associate a trucking company with a unit.

See also RejectTruckingCompanyNotAssignedForPickup (on page 1).

RejectTruckingCompanyBanned

Rejects a gate transaction if the specified trucking company is banned from the facility, or if the specified gate transaction type is not allowed for the trucking company. The RejectTruckingCompanyBanned business task is applicable at the gate transaction level and rejects a gate transaction if the trucking company is specified at the gate transaction level. If the trucking company is specified at the truck visit level, N4 generates an error for a banned trucking company irrespective of whether the RejectTruckingCompanyBanned business task is included in the gate configuration or not.

RejectTruckingCompanyDeprecated

Rejects a gate transaction if the specified trucking company has been deprecated by the facility.

RejectTruckingCompanyExpiredDriverAgreement

Rejects a gate transaction if there is no agreement between the trucking company and the driver or if the current date is past the Agreement Expiration date specified in the Trucking Company form (on page 1).

However, if an agreement between the trucking company and the driver exists but the Agreement Expiration date is not specified, N4 does not reject the gate transaction.

RejectTruckingCompanyExpiredInsurance

Description

The business task rejects a gate transaction if the trucking company insurance has expired. The business task does not reject a gate transaction if the expiration date is the same as the current date.

Parameters

None

Dependencies

None

Timing

• For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).

• For appointments, N4 processes business tasks on two occasions:

• If the business task is included in the Include column, N4 processes it when you click Save in the Appointment form (on page 1).

• If the business task is included in the Include Dispatch column, N4 processes it when you click Save after associating the appointment with a truck visit appointment.

• For truck visit appointments, N4 processes the business tasks when you click Save in the Truck Visit Appointment form (on page 1).

Custom Code

Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.

RejectTruckingCompanyExpiredLineAgreement

Description

The business task rejects a gate transaction if the agreement between the trucking company and the line operator has expired. The business task does not reject a gate transaction if the expiration date is the same as the current date.

Parameters

None

Dependencies

None

Timing

• For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).

• For appointments, N4 processes business tasks on two occasions:

• If the business task is included in the Include column, N4 processes it when you click Save in the Appointment form (on page 1).

• If the business task is included in the Include Dispatch column, N4 processes it when you click Save after associating the appointment with a truck visit appointment.

• For truck visit appointments, N4 processes the business tasks when you click Save in the Truck Visit Appointment form (on page 1).

Custom Code

Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.

RejectTruckingCompanyLineExpiredCredit

Rejects a gate transaction if the Credit Expiration Date specified in the line agreement between the line operator and the trucking company has passed.

RejectTruckingCompanyLineExpiredInsurance

Description

The business task rejects a gate transaction if the Insurance Expiration Date specified in the line agreement between the line operator and the trucking company has passed. The business task does not reject a gate transaction if the expiration date is the same as the current date.

Parameters

None

Dependencies

None

Timing

• For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).

• For appointments, N4 processes business tasks on two occasions:

• If the business task is included in the Include column, N4 processes it when you click Save in the Appointment form (on page 1).

• If the business task is included in the Include Dispatch column, N4 processes it when you click Save after associating the appointment with a truck visit appointment.

• For truck visit appointments, N4 processes the business tasks when you click Save in the Truck Visit Appointment form (on page 1).

Custom Code

Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.

RejectTruckingCompanyMoveRestriction

Rejects a gate transaction if the selected trucking company has an agreement with the line operator but the gate transaction type is not allowed for the selected trucking company, by the line operator. The move restrictions for a trucking company are listed in the Restrictions tab.

The RejectTruckingCompanyMoveRestriction business task does not reject a gate transaction if the restriction for the transaction type is Obsolete.

See also RejectTruckingCompanyNoLineAgreement (on page 1).

RejectTruckingCompanyNoLineAgreement

Rejects a gate transaction if the selected trucking company does not have an agreement with the line operator, if an agreement with the line operator is Obsolete, or if the gate transaction type is listed in the Line Operator form Gate Restrictions tab.

The RejectTruckingCompanyNoLineAgreement business task does not reject a gate transaction if the line operator does not have any trucking company agreements. Therefore, a line operator must have at least one agreement for N4 to enforce this validation.

See also, RejectTruckingCompanyMoveRestriction (on page 1).

RejectTruckingCompanyNoDriverAgreement

Description

The business task rejects a gate transaction if the driver is not associated with the trucking company involved in the transaction.

For information on how to associate a driver with a trucking company, see Driver form (on page 1).

You must include this business task at the truck visit, as well as, at the gate transaction level.

Parameters

None

Dependencies

None

Timing

• For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).

• For truck visits, N4 processes business tasks according to the value of the Timing column in the Business Tasks form. The Timing column can have any of the following values:

• pre-stage: The business task is processed when the truck arrives at a gate stage and validates whether the truck is at the correct gate stage.

N4 processes this business task when creating a truck visit or when you click the Save Transaction button on the <GateStage> tab for the first gate transaction.

If any pre-stage business task fails at the first gate stage, N4 does not create a truck visit, and does not allow the user to send the truck to Trouble.

• on-arrival: The business task is processed when the truck arrives at the Exchange area. N4 processes this task when you click on the Confirm Arrival button at the bottom of the <GateStage> tab or process the notify-arrival API.

The Confirm Arrival button is available only if you have included an on-arrival business task in your truck visit configuration and the Stage Type of the gate stage is Out-gate Stage.

• on-submit: The business task is executed after all the gate transactions are successfully saved for a gate stage. If the Check if All Done check box is selected for a gate stage, the on-submit business tasks are executed as soon as the gate clerk successfully saves the last gate transaction for that stage for the truck visit. If the Check If All Done check box is not selected for a gate stage, the on-submit business tasks are executed when the gate clerk clicks the Proceed to Next Stage button in the <GateStage> tab. For APIs it is when you execute the process-truck API or the stage-done API if the stage-done API is not executed from the process-truck API (do-stage-done is set to false).

• validation: The business task is executed when a truck visit is created after successful execution of the pre-stage business tasks, but before the execution of the on-submit business tasks.

If a validation business task fails, N4 creates the truck visit and allows the user to send the truck visit to Trouble to be resolved later.

• on-trouble: The business task is executed when the truck is sent to Trouble.

• area-done: The business task is executed when N4 determines that all the gate transactions for the truck visit that were for this exchange area are done at the yard stage.

This gate work flow is executed when either of the following conditions is true:

N4 receives an area-done message through the API.

A clerk successfully Saves the last gate transaction for the yard stage at this exchange area and before the clerk clicks the Proceed to Next Stage button for the truck from a gate form.

As the final step in a process-truck API message when all transactions have been submitted.

Automatically from the transaction-level on-submit workflow if the stage is configured to check if all transactions are submitted for that stage. If the transaction-level on-submit workflow passes successfully, N4 checks whether this is the last transaction to be submitted during this visit to an exchange area, meaning that the next transaction, which has not yet been submitted at this stage, is for a different exchange area. If this is the last transaction submitted at the stage, then N4 considers it the last transaction at the exchange area. If the exchange area is null, either because it is a non-exchange area move in a terminal that has exchange areas or the terminal has no exchange areas, then null is treated like any other individual exchange area value.

Custom Code

Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.

RejectTruckingCompanyNotAssignedForPickup

Description

The business task rejects a gate transaction if the trucking company specified at the gate does not match the trucking company assigned to pickup the container. You can use the Delivery Requirements form or the Group form (on page 1) to assign a trucking company for a unit.

The business task performs the following validations:

• If the unit is assigned to a group, it validates the trucking company specified at the gate with the trucking companies included in the group.

• If the unit is assigned to an Import Delivery Order (IDO), and if a trucking company is:

• Specified for the IDO: The business task validates the trucking company specified at the gate with the trucking company specified for the IDO.

• Not specified for the IDO: The business task ensures that only a house trucker can pickup the container.

• If a trucking company is specified at the unit level, it validates the trucking company specified at the gate with the trucking company specified for the unit.

Parameters

precedence: The business task uses this parameter (on page 1) to determine which trucking company to use to validate the trucking company at the gate. If you set, precedence as:

• unit: N4 must use the trucking company specified in the Delivery Requirements form.

• group: N4 must use the trucking company specified in the Group form.

Dependencies

If a trucking company is not specified for the unit, or if the trucking company is a designated house trucker for the line operator, then this business task does not return an error.

Timing

• For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).

• For appointments, N4 processes business tasks on two occasions:

• If the business task is included in the Include column, N4 processes it when you click Save in the Appointment form (on page 1).

• If the business task is included in the Include Dispatch column, N4 processes it when you click Save after associating the appointment with a truck visit appointment.

• For truck visit appointments, N4 processes the business tasks when you click Save in the Truck Visit Appointment form (on page 1).

Custom Code

Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.

RejectTruckingCompanyNotExamSiteCarrier

Description

Rejects a gate transaction if the specified unit has Exam Status of OFFSITE or OFFSITE&RETURN but the trucking company is not authorized as an Exam Site Carrier.

Parameters

None

Dependencies

None

Timing

• For appointments, N4 processes business tasks on two occasions:

• If the business task is included in the Include column, N4 processes it when you click Save in the Appointment form (on page 1).

• If the business task is included in the Include Dispatch column, N4 processes it when you click Save after associating the appointment with a truck visit appointment.

• For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).

• on-submit: The business task is executed after all the gate transactions are successfully saved for a gate stage. If the Check if All Done check box is selected for a gate stage, the on-submit business tasks are executed as soon as the gate clerk successfully saves the last gate transaction for that stage for the truck visit. If the Check If All Done check box is not selected for a gate stage, the on-submit business tasks are executed when the gate clerk clicks the Proceed to Next Stage button in the <GateStage> tab. For APIs it is when you execute the process-truck API or the stage-done API if the stage-done API is not executed from the process-truck API (do-stage-done is set to false).

Custom Code

Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.

RejectTruckingCompanyNotMatchingTruckRecord

Description

The business task rejects a gate transaction if the trucking company provided does not match the last trucking company used by this truck. N4 checks the Last Trucking Company field in the Truck form (on page 1).

Parameters

validateForNullTruckingCompany:To enable this parameter you must select the Validate Truck Record for Null Trucking Company check box. If you select the check box, N4 validates if the truck license has a valid trucking company associated with it in the Truck form (on page 1). If the last trucking company is set to null in the Truck form (on page 1), N4 displays an error message.

Dependencies

To update the Last Trucking Company (in the Truck form (on page 1)) used by a truck, include the UpdateTruck (on page 1) business task.

Timing

• For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).

• For truck visits, N4 processes business tasks according to the value of the Timing column in the Business Tasks form. The Timing column can have any of the following values:

• validation: The business task is executed when a truck visit is created after successful execution of the pre-stage business tasks, but before the execution of the on-submit business tasks.

If a validation business task fails, N4 creates the truck visit and allows the user to send the truck visit to Trouble to be resolved later.

Custom Code

Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.

RejectTruckingCompanyNotSeizedCargoCarrier

Rejects a gate transaction if the specified unit has the Inbond Status of INBOND but the trucking company is not authorized as a Seized Cargo Carrier.

RejectTruckingCompanyUnknown

Rejects a transaction if the specified trucking company does not exist.

Exclude this business task at the appointment stage if you do not want to reject an appointment created using the COPINO EDI message if the trucking company does not exist.

Include this business task at the appointment stage if you want to reject an appointment created using the COPINO EDI message if the trucking company does not exist.

RejectTruckingCoNotMatchingDesignatedBondedCarrier

Description

You can use this business task for units inbond or marked for an offsite exam and have a designated Bond Trucking Company, this business task prevents any other trucking company from picking up the unit..

Parameters

None

Dependencies

None

Timing

• For appointments, N4 processes business tasks on two occasions:

• If the business task is included in the Include column, N4 processes it when you click Save in the Appointment form (on page 1).

• If the business task is included in the Include Dispatch column, N4 processes it when you click Save after associating the appointment with a truck visit appointment.

• For gate transactions, such as Receive Export or Receive Empty, N4 processes tasks when you click the Save Transaction button on the gate transaction section of the <GateStage> tab (on page 1).

• on-submit: The business task is executed after all the gate transactions are successfully saved for a gate stage. If the Check if All Done check box is selected for a gate stage, the on-submit business tasks are executed as soon as the gate clerk successfully saves the last gate transaction for that stage for the truck visit. If the Check If All Done check box is not selected for a gate stage, the on-submit business tasks are executed when the gate clerk clicks the Proceed to Next Stage button in the <GateStage> tab. For APIs it is when you execute the process-truck API or the stage-done API if the stage-done API is not executed from the process-truck API (do-stage-done is set to false).

Custom Code

Any custom code associated with the business task is executed following the execution of this business task and has no impact on it.